home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / gdox811.zip / GOVDOX.DOC < prev    next >
Text File  |  1993-01-06  |  33KB  |  808 lines

  1.  
  2. GOVDOX
  3.  
  4. release 8.11
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38. (c) 1992, Clyde W. Grotophorst
  39.     GMUtant Software
  40.     Route 1, Box 296
  41.     Hamilton, VA 22068 USA
  42.  
  43.                                  GOVDOX
  44.  
  45.           GOVDOX is SHAREWARE...not FREEWARE or PUBLIC DOMAIN
  46.  
  47. Non-registered users of this software are granted a limited
  48. license to make an evaluation copy for trial use on a private,
  49. non-commercial basis, for the express purpose of determining whether
  50. GOVDOX meets their needs. At the end of this trial period, (30 days)
  51. you should either register your copy or discontinue use.
  52.  
  53. Registration licenses you to use the product on a regular
  54. basis. Registration also provides you with access to the GMUtant
  55. Online BBS ((703) 993-2219) as a registered user--where you may
  56. receive support, leave questions, requests for enhancements, or
  57. download the latest release of the program. The registered version
  58. offers expanded capabilities.
  59.  
  60. Once registered you will receive the latest version of GOVDOX by
  61.        return 1st class mail (please specify disk size).
  62.  
  63.                 Registration fee...............$ 50.00
  64.  
  65.     includes diskette by return mail, printed documentation,
  66.     30 days telephone support and one (1) instant update diskette.
  67.  
  68.  Extend instant update plan 12 additional months (2-3 disks)....$ 25.00
  69.  
  70.   Under the instant update plan, you receive any new release of
  71.   GOVDOX without having to call our BBS or send the $ 5.00 per
  72.   update fee.  We typically issue an update every 2-3 months
  73.               (adding features, correcting problems, etc.)
  74.  
  75.  
  76.           Send your name, address and registration payment to:
  77.  
  78.                           Clyde W. Grotophorst
  79.                             Route 1, Box 296
  80.                         Hamilton, Virginia 22068
  81.                                   USA
  82.  
  83.  
  84.                               Introduction
  85.  
  86. GOVDOX is an easy to use yet powerful system for checking-in U.S.
  87. Government documents. Beginning with release 7.0, GOVDOX was
  88. completely redesigned--keeping those features that helped make the
  89. earlier versions popular and improving the product in a number of
  90. areas.  Abandoning compiled dBASE has enabled us to improve the
  91. performance of the program in every area. Not only does this
  92. version of GOVDOX run much faster than earlier releases, it offers
  93. many more features:
  94.  
  95. GOVDOX features include:
  96.  
  97. o    Completely menu-driven. Bounce bar menus (with initial letter
  98.      activation) are used throughout the system.
  99. o    Full mouse support
  100. o    GOVDOX produces a true sort on SUDOC numbers without resort to
  101.      complicated data entry requirements or use of a stand-alone utility.
  102.      System 'normalizes' user input during data entry.
  103. o    If desired, GOVDOX can be run in read-only mode. Users
  104.      may search the database and extract reports but they may
  105.      not add, modify or delete records.  Allows GOVDOX to
  106.      serve as an OPAC for your documents collection.
  107. o    Search database(s) by any word found in a record.
  108. o    Descriptor field supports free-text searching with each
  109.      term indexed for fast retrieval regardless of database size.
  110. o    Move forward and backward or jump randomly through all
  111.      matching records.
  112. o    GOVDOX supports boolean AND, OR, or NOT searching. You may
  113.      also, if desired, limit matches to whole words (just
  114.      append a /w to your search term).
  115. o    When no match is found for an indexed term, GOVDOX shows
  116.      the user terms that file before and after the term that
  117.      was not found.
  118. o    Produces a wide variety of reports (database(s) sorted by
  119.      Sudoc Number, list of descriptors used in each database,
  120.      sorted list by Title, Sorted list by Title, etc).
  121. o    Online verification of descriptors during data-entry if
  122.      desired (support for controlled vocabulary).
  123. o    Export data in comma-delimited format accepted by most
  124.      dbms packages (e.g., dBASE, FoxBase, Paradox, etc).
  125. o    View ASCII files of any size without leaving GOVDOX.
  126. o    Global change capability provided. Change any text in any
  127.      field across the database. GOVDOX shows each change before it
  128.      is made, allowing you to skip record(s) if desired.
  129. o    Progress graphs for indexing/reindexing.
  130. o    User may modify help screen. Any ASCII file may serve as
  131.      online help for system.
  132.  
  133. o    Five indexes are stored in a single file.  This reduces
  134.      DOS overhead (file handles) and speeds indexing operations.
  135. o    SHELL TO DOS without exiting the system. System compresses
  136.      GOVDOX in memory to free more RAM for your dos prompt.
  137. o    Database (and index) may be stored on drives other than
  138.      that used to store program file (e.g., on a LAN).
  139. o    Automatic date stamping of records during data entry.
  140. o    Deleted records are reused before new records are added
  141.      (minizing disk space and eliminating need to 'pack' file.
  142. o    Full b-tree indexing speeds retrieval.
  143. o    Boyer-Moore search algorithm used on full record search,
  144.      improving retrieval by 200% over brute force (field by
  145.      field) comparison.
  146. o    Reports from GOVDOX are written to ASCII files, enabling
  147.      use of any word processor for production of final printout. 
  148. o    GOVDOX produces a list of unique item numbers on
  149.      demand...including the number of documents using each
  150.      number.
  151.  
  152.                               INSTALLATION
  153.  
  154. First, make sure your system has the following 2 statements in your
  155. CONFIG.SYS file:
  156.  
  157.         Files=20
  158.         Buffers=20
  159.  
  160. To find out whether your machine has a CONFIG.SYS file, issue the following
  161. commands at a DOS prompt:
  162.  
  163. PROMPT $P$G [press return]. You may already be using this prompt string, but
  164. if not, at least from here on out you will know what drive and directory
  165. you are defaulting to.
  166.  
  167. C: [press return...we want to log onto the C: drive]
  168.  
  169. CD\ [press return], this should put us in the root directory a 'C:\>' prompt
  170. should appear. If so, type the following command:
  171.  
  172. DIR C*.SYS [press return]
  173.  
  174. If you do not see a file named CONFIG.SYS in the newly displayed text, you can
  175. safely assume that one does not exist. 
  176.  
  177. To Create a CONFIG.SYS file, issue the following commands at C:\>
  178. prompt (to be a bit more technical, while logged onto the root directory
  179. of the boot drive (typically C:) of your system):
  180.  
  181. Copy Con: CONFIG.SYS [press return]
  182. FILES=20   [press return]
  183. BUFFERS=20 [press F6]
  184.  
  185.  
  186. CONFIG.SYS file is read only during initial boot of your system.
  187. Questions about this can be resolved by looking at your DOS manual.
  188.  
  189.                   Files needed to run a GOVDOX system
  190.  
  191. Installing GOVDOX is simple. You need only two files to run the system
  192. (GOVDOX.HLP and GD.EXE). If you are familiar with DOS, just create a
  193. subdirectory (e.g., GOVDOX) and copy the two files to that
  194. subdirectory. Type GD at the DOS prompt when you're ready to begin.
  195.  
  196. The first time you run the program, you'll be prompted to create a
  197. database. We suggest you use the name GOVDOX for your database but it's
  198. not required.   Any word (up to 8 characters) may be used. GOVDOX will
  199. create the database using the name you give, adding a DAT extension file
  200. for the datafile and an IX extension for the index.
  201.  
  202.               Command Line Switches (DatabaseName  /p /m )
  203.  
  204. OPAC (Online Public Access Catalog) . If you want to have others
  205. use your GOVDOX database but don't want them adding, deleting,
  206. or editing records, begin GOVDOX with the /p switch. This
  207. activates OPAC mode, disabling the Add function and Maintenance Menu.
  208.  
  209. /m forces monochrome operation. GOVDOX will automatically sense a
  210. mono card and use the appropriate colors.  You may need to use the
  211. mono switch if you're using a monochrome VGA system--which appears
  212. as a color monitor at the hardware level.
  213.  
  214.                               OPENING MENU
  215.  
  216. When you type GD at the DOS prompt, several things happen...
  217.  
  218. 1) the program allocates RAM for in-memory storage of the indexes.
  219.  
  220. 2) if you are using the SHAREWARE version, a reminder to register
  221. screen appears (actually appears about 50% of the time).
  222.  
  223. 3) the program next checks your disk to see how many *.DAT
  224. files can be found...
  225.  
  226.      a) One *.DAT file found, GD opens that database.
  227.      
  228.      b) More than one, a pick-list appears. Select the file you want to
  229.      use by moving the light bar with the cursor arrows until desired
  230.      file is highlighted--then press RETURN (or double-click mouse on
  231.      desired file).
  232.  
  233. 4) the main menu appears.
  234.  
  235.                            Main Menu Options
  236.  
  237. L  List items in the database. This option allows you to move through
  238.    the database a record at a time. The records appear in the order in
  239.    which they were entered into the system. Pressing L on the main menu
  240.    takes you to the last record in the file (the assumption being that
  241.    you are probably more interested in the more recent records). You
  242.    may move about the file via the J (Jump) command--which 'jumps'
  243.    you to the record number you enter.
  244.  
  245. S  Search a database. Supports a variety of search types.
  246.  
  247. E  Export data. Enables user to produce a variety of reports, including
  248.    bibliographies.
  249.  
  250. V  View ASCII file(s). Allows user to look at an ASCII file.
  251.  
  252. M  Maintenance functions. This function provides a variety of
  253.    support operations (adding records, rebuilding indexes, creating
  254.    new databases, deleting databases, Shell to DOS, etc).
  255.    Disabled if /p (read-only) switch is used at startup
  256.    (e.g., GD /p [return]).
  257.  
  258. D  Database selection. Once you have created a second database,
  259.    this function allows you to move between database files.
  260.  
  261. I  Information on GOVDOX.  Pressing I on the Main Menu causes the
  262.    file GOVDOX.HLP to display in a window on your screen. To create
  263.    your own help file, make an ASCII file and name it GOVDOX.HLP.  You do
  264.    not have to worry about page breaks or other formatting.
  265.  
  266. Q  Quit to DOS. Closes all files, halts program and exits.
  267.                            1. ADDING RECORDS
  268.  
  269. Adding records to your database is fairly simple. Press A on the main menu
  270. or move the highlight bar to the top of the menu (highlighting "A   Add an
  271. item to the file") and press return
  272.  
  273. A blank record will appear on the screen. You can begin entering data for
  274. that item.
  275.  
  276. Two keystrokes activate special windows during data entry and/or editing:
  277.  
  278.  F1    displays a chart of keystrokes supported by the GOVDOX
  279.        data entry/edit function.
  280.  
  281. ALT-V  Compares the terms entered in the descriptor field with those
  282.        already in use.  If the term(s) you're using in this record
  283.        have been used before, they'll have a check mark beside them.
  284.        You can use this function to help maintain a controlled vocabulary.
  285.  
  286. Note that GOVDOX performs a bit of post-edit processing on a SUDOC number. 
  287. First, all spaces (except the one that must appear between the initial
  288. letters (for agency) and the first integer of the SUDOC number. GOVDOX
  289. will strip all other spaces out of the number as it is filed.
  290.  
  291. The date field will automatically show today's system date. You can edit
  292. this if desired but pressing RETURN while the cursor is on the field
  293. accepts the default date shown.
  294.  
  295. Once you have completed entering data in a particular record, you must
  296. press ESCAPE -- or press return when the cursor is in the location
  297. field.  As an alternative, you can press ^KD or ^Enter.  Any of these
  298. keystrokes halts the add/edit process and presents you with a menu
  299. along the status line at the bottom of the screen:
  300.  
  301. Save & continue    Carry after saving    File & stop     Abandon this
  302.  
  303. You can press the highlighted character associated with each option to
  304. activate it (e.g., S for Save & continue) or move the highlight bar
  305. via the cursor arrow key--pressing RETURN when the desired option is
  306. highlighted.  If you have a mouse, you can click on the desired
  307. option.
  308.  
  309. Save & continue:     Files record, then brings up another blank record.
  310. Carry after saving:  Files this record, then copies the data in this
  311.                      record to a new record.  This is useful for those
  312.                      instances where you have several items to enter
  313.                      that vary only slightly.
  314. File & stop:         Files this record then exits the add function.
  315. Abandon:             Discards the data just entered and exits the
  316.                      add function.
  317.                               2. SEARCHING
  318.  
  319. Pressing S on the Main Menu activates the Search Menu.  You can search
  320. a GOVDOX database in several ways:
  321.  
  322.                         Sudoc Number (indexed).
  323.  
  324. This searches the sudoc number index. Retrieval is very quick
  325. (under 2 seconds regardless of database size).  You can
  326. enter a STEM and GOVDOX will match all records that begin with the
  327. stem.  Matching occurs from the left hand margin of the Sudoc
  328. number field.  When no match occurs, GOVDOX displays near misses.
  329.  
  330.                             Title (indexed).
  331.  
  332. Like Sudoc number searching, this field is indexed
  333. for fast retrieval. You must enter the beginning text of a particular
  334. title.  When no match is found, GOVDOX will show you those titles
  335. that file both before and after where your title search text would
  336. have appeared had it been in the file.
  337.  
  338.                          Keyword (indexed).
  339.  
  340. Again, like Sudoc and Title searches, the keyword(s) field is
  341. indexed. Each term in the field (a term being anything with a space
  342. on either side of it, up to a total of five terms per field) is indexed.
  343. You can search for any individual term that appears in the keyword
  344. field.  The 'near-miss' display (mentioned above) appears when
  345. no match is found.
  346.  
  347.                                 Boolean.
  348.  
  349. Unlike the first three search methods, Boolean is a non-indexed
  350. search.  It is slower than indexed searching but it has the virtue
  351. of finding matches *anywhere* in a GOVDOX record. When B is pressed
  352. on the Search Menu, a boolean function screen appears.  You must
  353. first tell the system whether you want an AND search, an OR search
  354. or a NOT search. You can press the highlighted letter if
  355. desired (A, O  or N).
  356.  
  357. You'll be shown a screen with four blank fields:
  358.  
  359. Term 1 >
  360. Term 2 >
  361. Term 3 >
  362. Term 4 >
  363.  
  364. You enter each individual term (or phrase) in the fields. If you want
  365. to limit a particular term to whole-word matching, append a /w on the
  366. end of the term (as shown for the second term in the example below):
  367.  
  368. Term 1 > Asia
  369. Term 2 > Handbook/w
  370.  
  371. When you have entered all desired terms, press ESC (pressing RETURN
  372. when the cursor is in the 'Term 4 > ' field also completes the data
  373. entry phase).
  374.  
  375. You will next be asked whether matches should go to disk (an ascii
  376. file, suitable for printing or distribution) or screen.  You can hit
  377. RETURN and the default (screen) will be selected.  If you want the
  378. matches to go to disk, press D or move the highlight bar to DISK and
  379. press RETURN.
  380.  
  381. A graph will appear and GOVDOX will report progress as it moves
  382. through the database looking for matches.  The entire file is
  383. searched, then the matching records (gathered into a set) are
  384. presented.  GOVDOX will show up to 5000 matches for any given
  385. search.  If your search results in more than 5000 matches, you'll
  386. be shown the first 5000 and warned that more matches were found.
  387. You should narrow your search.
  388.  
  389. Note: When sending to disk, the 5000 match limit is waived.  All
  390. matching records will be written to disk.
  391.  
  392.                          Full-record searching
  393.  
  394. Like Boolean searching, Full-record searches enable you to match
  395. for text anywhere in a record.  You can, as with boolean, add a
  396. /w to your search term to limit the system to whole-word matches.
  397. Non-Indexed Searches (switches):
  398.  
  399. There are 2 switches that can be added to your search statements: /w /p
  400.  
  401.                         (/w) Whole-Word Matching
  402.  
  403. When you add a /w to your search term under either FULL or
  404. BOOLEAN searching, you're asking GOVDOX to ignore those
  405. instances where the text you enter appears in a record but
  406. not as a whole word (e.g., you've entered hand but don't want
  407. matches on handbook). GOVDOX uses the following definition for
  408. a word:  any text with a space (or punctuation) on each end of
  409. the term.
  410.  
  411.                         (/p) Matches to printer
  412.  
  413. Adding the /p switch will cause GOVDOX to send matching records to
  414. the printer instead of the screen (single line of output per
  415. record).  If your printer is malfunctioning (or not turned on),
  416. you'll receive an error message--offering you the option of fixing
  417. the problem and continuing or abandoning the search.
  418.  
  419. You can use both switches if desired (e.g., hand/w/p  would send
  420. matches on the whole-word HAND to the printer).
  421.  
  422.                       DISPLAY of MATCHING RECORDS
  423.  
  424. Once the set of matches has been assembled, the matching records
  425. will be presented to you.  The lower center of the display window
  426. will report which record is being viewed (e.g., Match 1 of 31).
  427. You have several options (shown on the menu along the status line):
  428.  
  429. F or Forward  -  moves to the next record
  430. B or Backward -  moves to the previous record
  431. E or Edit     -  allows you to EDIT the displayed record
  432. D or Delete   -  allows you to DELETE the displayed record
  433. S or Save     -  writes the record to an ASCII file (named QUERY.TXT)
  434. T or Transfer -  writes the record in GIX format to TRANSFER.GIX
  435. P or Print    -  prints the displayed record
  436. J or Jump     -  allows you to jump to another record in the set.
  437.                  When you press J a window appears. Enter the number
  438.                  of the record you want to move to and press return.
  439.  
  440.                                3. EXPORT
  441.  
  442. The export option is activated by pressing E on the Main Menu.  You
  443. are shown several report options.  All reports that go to disk are
  444. written as plain ASCII files--suitable for import into your favorite
  445. word processor.
  446.  
  447. S - Sudoc Number.   All records in the file are written to disk in
  448.                     SUDOC number order. You're offered the choice
  449.                     between brief and full format. Here's a sample
  450.                     of each
  451.  
  452.                     FULL format (3 lines per entry)
  453.  
  454.  
  455. GS 1/29:NO                      0580-A-01  02Feb90
  456. Federal Travel Directory
  457.   STACKS
  458.  
  459. HE 3615/2:88-10                 0508-H-01  06Mar89
  460. Indoor Air Pollution Part 1: Radon
  461.   MED
  462.  
  463.                     Brief format (1 line per entry)
  464.  
  465. A 57.38: C 87/988      SOIL SURVEY OF CROCKET COUNTY, TENNESSEE
  466. A 67.7/2: VOL/#        FOREIGN AGRICULTURE (CHANGED TO AGEXPORTER 1989)
  467.  
  468. Note that brief format makes a nice shelflist if all you need is sudoc
  469. number and title. You can use TITLE (option 2) to create a shelflist
  470. sorted by title.
  471.  
  472. If you also want the item number to appear, use option M to create the
  473. shelflist.  Option M also adds a '___' before each line to enable you
  474. to use the list to check-off selected entries:
  475.  
  476. ___ A 1.2:C18/7/FOLDER             0010       Careers USDA
  477. ___ A 1.2:C18/8/Admin.             0010       Administration
  478. ___ A 1.2:C18/8/BUS.               0010       Business and Industry
  479. ___ A 1.2:C18/8/SCIENCE            0010       Science and Technology
  480. ___ A 1.2:C18/DIR.                 0010       Directory
  481.  
  482. GOVDOX will perform a sudoc number sort for these shelflists that is
  483. better than 99% accurate.  Any numbers that don't sort correctly will
  484. likely appear at the head of the list--an excellent way to find
  485. typos.
  486.  
  487.                    Other export reports of interest:
  488.  
  489. Keywords:     Generates an ASCII file of all keywords currently
  490.               in use.  Beside each term a number appears letting you
  491.               know how many records use this term.
  492.  
  493. UNIQUE ITEMS: This report produces a list of all unique item numbers
  494.               in your database.
  495.  
  496. BIBLIOGRAPHY: This option creates a file of all records containing
  497.               a particular string in a particular field.
  498.  
  499. GIX FILE:     If you need to archive a database, you can create a GIX
  500.               file. This will be smaller than your database since only
  501.               the fields that have data are stored (not the blank
  502.               spaces or empty fields).  You can read a GIX file into
  503.               GOVDOX via the Maintenance menu.
  504.  
  505.  
  506. COMMA-DELIMITED: Use this option if you want to move a GOVDOX database
  507.                  to some other package (e.g., dBASE).  Each field is
  508.                  written surrounded by quote marks, with a carriage
  509.                  return/line feed at the end of each record. If you
  510.                  use with dBASE, you can append this file using the
  511.                  'delimited' keyword (e.g., APPEND FROM GDOX.TXT
  512.                  DELIMITED).
  513.  
  514.                          4. VIEW ASCII FILE(S).
  515.  
  516. This option provides a viewer for small ASCII files (e.g., GOVDOX.DOC).
  517. If a file in your GOVDOX subdirectory has a DOC, GIX, TXT or RPT
  518. extension, it will appear in the view pick-list.  Move the highlight
  519. bar to the desired file and press RETURN.  An ASCII file viewer will
  520. allow you view the file's contents.  Press PgUP and PgDn to move
  521. inside the file.
  522.  
  523. NOTE: This viewer can not view files larger than available RAM. If the
  524. file is large, you'll have to use your word-processor or a utility
  525. program like LIST.COM.
  526.  
  527.                              5. MAINTENANCE
  528.  
  529. The Maintenance menu (reached by pressing M on the Main Menu) offers
  530. several options. Each is discussed below (in the order of appearance
  531. on the menu):
  532.  
  533. List Records in the database.
  534.  
  535.         Pressing L on the Maintenance Menu moves you the end of the
  536.         database and displays the final record in the file (the
  537.         assumption being that you want to review records you've
  538.         just added).  You can move freely through the database
  539.         or use the J (JUMP) command to move to a particular record.
  540.  
  541. Rebuild Index.
  542.  
  543.         This function purges deleted records (not necessary if you're
  544.         typically adding records to your file...GOVDOX reuses
  545.         deleted records before physically adding a new record to
  546.         the file) and rebuilds the *.IX (index) file. You must run
  547.         this option if you rebuild/repair a database using GRX.EXE
  548.         (as that program does not do a complete job of rebuilding
  549.         the GOVDOX index(es).
  550.  
  551. Shell to DOS.
  552.  
  553.         This function compresses the heap (to free up additional
  554.         RAM) then shells out to the DOS prompt.  Type EXIT to
  555.         return to GOVDOX.
  556.  
  557. Make a New Database.
  558.  
  559.         Use this function to create a new database. You supply
  560.         up to an 8 character name and GOVDOX creates an empty
  561.         DAT and IX file.  After creating this file, you'll have
  562.         to use the DATABASE SELECTION option on the main menu
  563.         to make it your active file.
  564.  
  565. Delete an Existing Database.
  566.  
  567.         Deletes a database and its associated IX (index) file.
  568.         You can not delete your active database with this
  569.         option.
  570.  
  571. Global Find & Replace.
  572.  
  573.         Allow you to make changes to a particular field across
  574.         your database.  The indexes are updated dynamically
  575.         during this process. Operation of the Find & Replace
  576.         function is straightforward:
  577.  
  578.         1. Select the field you want to modify from the menu
  579.            that displays (sudoc, item number, title, and so on.
  580.         2. Enter the text you want GOVDOX to find, then enter
  581.            the replacement text.  Take care to insure that
  582.            your replacement text does not contain your find
  583.            text string--lest you set off an endless loop of
  584.            changes.  Note that GOVDOX will only change text
  585.            when an EXACT match for your search text is found.
  586.            CASE is significant!
  587.         3. GOVDOX will show you your 'find' and 'replace' strings.
  588.            Once you agree that they are correct, the search begins.
  589.  
  590.         Each record that contains your 'find' search string will
  591.         cause GOVDOX to display the old field and the proposed
  592.         new field. If you agree with the change, press Y. If
  593.         you want to skip the change for this record, press N.
  594.         If, after reviewing several proposed changes, you decide
  595.         that GOVDOX can proceed making the change automatically
  596.         across the database, press A.
  597.  
  598. Import ASCII (GIX) file.
  599.  
  600.         Use this option to read a GIX file into a database.
  601.  
  602.  
  603.                          6. DATABASE SELECTION
  604.  
  605. Pressing D on the main menu activates the DATABASE SELECTION
  606. function.  If you have more than 1 database in your GOVDOX
  607. subdirectory, a list of databases will appear. Move the
  608. highlight bar to the desired database and press return. That
  609. file is now your active database.  Note: The GOVDOX status
  610. line always reports the active database and the number of
  611. records contained in that file).
  612.  
  613.                         7. INFORMATION ON GOVDOX.
  614.  
  615. This option (I on the Main Menu) brings up a copy of the ASCII
  616. file GOVDOX.HLP.  You can substitute any ASCII file for GOVDOX.HLP
  617. if desired.
  618.  
  619.  
  620.                        Miscellaneous information
  621.  
  622. 1. Using GRX.EXE
  623.  
  624. If you experience a failure with a GOVDOX database (for example,
  625. an error message informing you that the index is corrupt), run the GRX
  626. utility. This file will read your existing database (*.DAT) and rebuild
  627. the proper structure. It will also create an empty index (*.IX) file.
  628. Once GRX has run you must rebuild the index for the database using
  629. GOVDOX (option R on the Maintenance Menu).  The most common cause
  630. for database corruption is turning the PC off during data entry
  631. or reindexing...under normal operating conditions (where the user
  632. always exits the program from the main menu), you should never have to
  633. rebuild a file.
  634.  
  635. 2. Backup?
  636.  
  637. Many users have found that using the GIX option under Export
  638. provides a space-saving means of making a backup copy
  639. of your database(s). Since only the data from your database is
  640. exported (not the empty spaces inside each record), the resulting
  641. file is usually about 40% smaller than your database.
  642.  
  643. With ASCII Import (on Maintenance menu), you can read this file
  644. back into GOVDOX should you ever need to reconstitute your database.
  645.  
  646. You may also use LHA.EXE, included on your distribution diskette. LHA
  647. will backup a GOVDOX database...saving approximately 80% of the
  648. space required to store the uncompressed data.
  649.  
  650. Syntax for using LHA:
  651.  
  652. The basic syntax for using LHA is as follows:
  653.  
  654. LHA (action) (archive name) (list of files to include)
  655.  
  656. For example, to compress (backup) a database named GOVDOX (e.g., GOVDOX.DAT
  657. and GOVDOX.IX) into an archive file named GDOX.LZH use the following
  658. command:
  659.  
  660.                 LHA A GDOX.LZH GOVDOX.DAT GOVDOX.IX [return]
  661.  
  662. To decompress this file at a later date, enter:
  663.  
  664.                 LHA E GDOX.LZH [return]
  665.  
  666. The files GOVDOX.DAT and GOVDOX.IX will be decompressed and extracted
  667. from the archive file GDOX.LZH.
  668.         
  669. 3. GOVDOX Memory Requirements:
  670.  
  671. GOVDOX requires 420K of free RAM at the DOS prompt.
  672. If you have more RAM, it will be used for in-memory storage of
  673. the indexes.
  674.  
  675. 4. GOVDOX Record Structure:
  676.  
  677. Here is the pascal structure for a GOVDOX record:
  678.  
  679.  document = RECORD
  680.        recordstatus : longint;  { deleted?}
  681.         sudoc       : string[30];
  682.         itemno      : string[10];
  683.         Title       : string[70];
  684.         subject2    : string[50];
  685.         note1       : string[40];
  686.         mediatype   : string[1];
  687.         datefld     : string[7];
  688.         loc         : string[1];
  689.      END;
  690.  
  691.  
  692. Sample file sizes (9013 records):
  693.  
  694. Datafile   (e.g., GOVDOX.DAT):  1992094 bytes (1.9 Mb)
  695. Index file  (e.g., GOVDOX.IX):  3097560 bytes (3.0 Mb)
  696.  
  697. Thus, to store 9000 records, you need approximately 5 Mb of disk space.
  698. While the index is larger than the datafile (primarily because it is
  699. also storing the sortable sudoc number), it does not grow in a 1:1
  700. relationship with an added record.
  701.  
  702. 5. GIX file format?
  703.  
  704. Here is the format of a GIX file. Note that each field has a 2 character
  705. label followed by a colon and a space. Each record is separated by two
  706. asterisks (**).
  707.  
  708. **
  709. SD: GA 1/13:HRD-86-20(MF)
  710. IT: 0546-D
  711. TI: GAO Report, Second-year Implementation of the Federal Manager's Financ
  712. KY: Microfiche
  713. NO: Sent to Film area each June
  714. TY: A
  715. LO: C
  716. DA: 19Feb90
  717. **
  718.  
  719. Many users find GIX files are great for doing massive edits
  720. across a database (assuming you have an ASCII editor or know how to
  721. save an ASCII file from within your favorite word-processor).  Just
  722. export your database as a GIX file, then use your editor to make
  723. global changes across the file. When you're finished, save it back
  724. as a plain ASCII file (e.g., CTRL-F5,Text,Save in WordPerfect).
  725. Create a new database structure within GOVDOX to hold this new data
  726. (we don't want to import it into the same database we used to get
  727. the GIX file or we'll have duplicates). Import it into the new
  728. database via Maintenance. When you're convinced it all worked
  729. correctly, just delete the older version of the database.
  730.  
  731.  
  732. 6. GOVDOX.INI (the display text configuration file)
  733.  
  734. To speed data entry and conserve a bit of disk space, GOVDOX uses
  735. codes to determine the proper display text for the media type
  736. and location fields.  For each field, you can have 25 different
  737. values (letters A-Y). The Z value for each is reserved for those
  738. records that don't have any value entered in the field during
  739. data entry.
  740.  
  741. GOVDOX assigns the display text to each code based on the configuration
  742. file named GOVDOX.INI (a plain ASCII file that *must* be in the same
  743. subdirectory with GD.EXE and GOVDOX.HLP.
  744.  
  745. You can create GOVDOX.INI with the GE (GMUtant Editor) program
  746. provided with the registered version, or any word processor capable
  747. of producing ASCII files. If using a word processor, be sure to save
  748. the file in ASCII form (e.g., save via CTRL-F5 if using WordPerfect).
  749.  
  750. Here's a sample GOVDOX.INI file
  751.  
  752. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  753. *  GOVDOX.INI                                                     *
  754. *  GOVDOX configuration file for display text. LOCATION values    *
  755. *  stored in "LOCA=" thru "LOCY=". The LOCZ= value will be used   *
  756. *  whenever a record has no entry (A-Y) in the location and/or    *
  757. *  mediatype field.  You may put comments in this file, just be   *
  758. *  sure the line begins with a * in the first position from the   *
  759. *  left.  If you edit this file with a word processor, be sure    *
  760. *  to save it to disk in pure ASCII form (e.g., CTRL-F5 not F7    *
  761. *  when using WordPerfect                                         *
  762. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  763.  
  764. OPAC=No                                 Change to YES for OPAC mode
  765.  
  766. LOCA=Stacks. General circulation
  767. LOCB=Documents room.
  768. LOCC=Reference desk.
  769. LOCZ=Documents. Non-Circulating                    (default)
  770.  
  771. TYPA=Microfiche
  772. TYPB=Microfilm
  773. TYPC=Serial
  774. TYPD=CD-ROM
  775. TYPZ=Monograph                                     (default)
  776.  
  777. As you can see, you don't need to enter a value for every letter under
  778. the two types. When GOVDOX first initializes, it assigns the text
  779. "Not Specified" for every letter. Then GOVDOX.INI is read and any letter
  780. that's referenced gets overwritten with the new value.  If GOVDOX
  781. finds a record with no value in either the location or mediatype fields,
  782. then the Z value is assigned (for display purposes only). The record
  783. *does not* have a Z added.  The important point here is to remember
  784. that the Z text will be used for records without a code.
  785.  
  786. Enter only one location or media type per line.  The significant text
  787. for each line begins in the 6th position of the line.
  788.  
  789. For location display text, you may have up to 40 characters following
  790. the "=" sign. For media type display text, you may use up to 15 characters
  791. following the "=" sign.  In each case, text that exceeds the limit is
  792. ignored.
  793.  
  794.  
  795.  
  796. When doing data entry or editing, pressing F3 will put a copy of your
  797. GOVDOX.INI file in the file viewer...
  798.  
  799.  
  800.  
  801. GOVDOX.EXE has been compressed with PKLITE version 1.15
  802.  
  803. Questions, comments, praise, complaints:
  804.  
  805. Contact Clyde Grotophorst, Route 1, Box 296, Hamilton, Virginia 22030
  806. phone: 703 993-2239 email: wallyg@fen1.gmu.edu CompuServe: 70404,3376
  807.  
  808.